home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / f90 / cry2mips.z / cry2mips
Text File  |  1998-10-30  |  6KB  |  141 lines
  1. CRY2MIPS(3F)                                          Last changed: 2-25-98
  2.  
  3.  
  4. NNAAMMEE
  5.      CCRRYY22MMIIPPSS, MMIIPPSS22CCRRYY - Converts Fortran data types between Cray Fortran
  6.      data types and MIPS IEEE Fortran data types
  7.  
  8. SSYYNNOOPPSSIISS
  9.      IINNTTEEGGEERR CCRRYY22MMIIPPSS, MMIIPPSS22CCRRYY
  10.  
  11.      _i_e_r_r == CCRRYY22MMIIPPSS((_t_y_p_e,, _n_u_m,, _f_o_r_e_i_g_n,, _b_i_t_o_f_f,, _n_a_t_i_v_e,, _s_t_r_i_d_e,, _n_a_t_l_e_n,,
  12.      _f_o_r_l_e_n[[,,_n_a_t_i_v_e_c_h]]))
  13.  
  14.      _i_e_r_r == MMIIPPSS22CCRRYY((_t_y_p_e,, _n_u_m,, _f_o_r_e_i_g_n,, _b_i_t_o_f_f,, _n_a_t_i_v_e,, _s_t_r_i_d_e,, _n_a_t_l_e_n,,
  15.      _f_o_r_l_e_n[[,,_n_a_t_i_v_e_c_h]]))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      UNICOS systems (except CRAY T90 systems that support IEEE arithmetic)
  19.  
  20.      IRIX systems
  21.  
  22. DDEESSCCRRIIPPTTIIOONN
  23.      CCRRYY22MMIIPPSS converts Cray Fortran data types (abbreviated as "Cray" in
  24.      the following text) to data for systems that use MIPS IEEE Fortran
  25.      data types (abbreviated as "MIPS" in the following text).
  26.  
  27.      MMIIPPSS22CCRRYY converts MIPS IEEE Fortran data types to Cray Fortran data
  28.      types.
  29.  
  30.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  31.      UNICOS or IRIX systems, all arguments must be of default kind unless
  32.      documented otherwise.  On UNICOS systems, the default kind is KKIINNDD==88
  33.      for integer, real, complex, and logical arguments; on IRIX systems,
  34.      the default kind is KKIINNDD==44.
  35.  
  36.      The following is a list of valid parameters for this routine.
  37.  
  38.      _t_y_p_e    An integer giving the data type code, as follows.
  39.  
  40.              CCooddee   DDeessccrriippttiioonn
  41.  
  42.              1      Typeless (no translation; _n_a_t_l_e_n and _f_o_r_l_e_n must be
  43.                     equal and must be 64-, 128-, or 256-bits.)
  44.  
  45.              2      Integer
  46.                     Cray:  64-bit twos complement
  47.                     MIPS:  8-, 16-, 32- or 64-bit twos complement
  48.  
  49.              3      Real
  50.                     Cray:  64- or 128-bit Cray real
  51.                     MIPS:  32-, 64-, or 128-bit MIPS real
  52.  
  53.              4      Complex
  54.                     Cray:  2 x 64 bit or 128-bit floating-point
  55.                     MIPS:  2 x 32, 64-bit, or 128-bit floating-point
  56.  
  57.              5      Logical
  58.                     CRAY: 64-bit positive/negative logical
  59.                     MIPS:  8-, 16-, 32-, or 64-bit zero/nonzero logical
  60.  
  61.              6      Character
  62.                     ASCII to ASCII; no translation.
  63.  
  64.              The _n_a_t_l_e_n and _f_o_r_l_e_n parameters select the size of the data.
  65.  
  66.      _n_u_m     Number of data items to convert.  Type integer variable,
  67.              expression, or constant.
  68.  
  69.      _f_o_r_e_i_g_n Variable or array of any noncharacter type or length to
  70.              contain data which is not native to the current system.
  71.  
  72.      _b_i_t_o_f_f  Integer variable, expression, or constant giving the bit
  73.              offset within the _f_o_r_e_i_g_n data variable or array to begin the
  74.              conversion.  _b_i_t_o_f_f must be at least 0 and no more than 63.
  75.  
  76.      _n_a_t_i_v_e  Variable or array of any noncharacter type or length to
  77.              contain data which is native to the current system. This
  78.              variable or array should be of a type that corresponds to
  79.              _t_y_p_e.  If _t_y_p_e=6, use a dummy integer variable and the
  80.              _n_a_t_i_v_e_c_h parameter (see description of _n_a_t_i_v_e_c_h).
  81.  
  82.      _s_t_r_i_d_e  Integer variable or constant giving the memory increment for
  83.              loading or storing data to the native array.  For two and
  84.              four-word items (complex and double-precision), this is a
  85.              stride of items, not of words.  For typeless, stride is always
  86.              in words.
  87.  
  88.              This parameter is ignored for CHARACTER (_t_y_p_e = 6).  Data in
  89.              the foreign array is loaded or stored in a continuous bit
  90.              stream regardless of this parameter.
  91.  
  92.      _n_a_t_l_e_n  Native storage length of an item, in bits.  For COMPLEX data,
  93.              _n_a_t_l_e_n counts the total size of the real and imaginary
  94.              component.
  95.  
  96.      _f_o_r_l_e_n  Fortran storage length of an item, in bits.  For COMPLEX data,
  97.              _f_o_r_l_e_n counts the total size of the real and imaginary
  98.              components.
  99.  
  100.      _n_a_t_i_v_e_c_h
  101.              Optional character parameter specifying _n_a_t_i_v_e target variable
  102.              if it is of type character (_t_y_p_e = 6).  This parameter is
  103.              ignored if _t_y_p_e is not character.
  104.  
  105. RREETTUURRNN VVAALLUUEESS
  106.      The returned function values are as follows:
  107.  
  108.      <<00   Parameter error; no translation performed.
  109.  
  110.      --11   Parameter error; too few arguments or _n_a_t_i_v_e_c_h not specified with
  111.           _t_y_p_e = 6. This error is not returned on IRIX systems.
  112.  
  113.      --22   Parameter error; invalid _t_y_p_e.
  114.  
  115.      --33   Parameter error; invalid _n_u_m.
  116.  
  117.      --44   Parameter error; invalid _b_i_t_o_f_f.
  118.  
  119.      --55   Parameter error; invalid _n_a_t_l_e_n.
  120.  
  121.      --66   Parameter error; invalid _f_o_r_l_e_n.
  122.  
  123.      --77   Unable to mmaalllloocc() memory for translation.
  124.  
  125.      --88   Combination of _n_a_t_l_e_n and _f_o_r_l_e_n is invalid.
  126.  
  127.      --99   _n_a_t_i_v_e must be 64-bit word-aligned (CRAY only)
  128.  
  129.      --1100  _f_o_r_e_i_g_n must be 64-bit word-aligned.
  130.  
  131.       00   Translation complete; no errors.
  132.  
  133.      >>00   Translation complete; return value is the number of integer or
  134.           real values that completely overflowed during conversion.
  135.           Overflows and NaNs which exist before conversion are not
  136.           included.
  137.  
  138. SSEEEE AALLSSOO
  139.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication
  140.      SR-2165, for the printed version of this man page.
  141.